home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / shareware / share_36 / midi / !Midi / !Help < prev    next >
Text File  |  1990-10-26  |  9KB  |  164 lines
  1. >!Help for !Midi - A simple desktop MIDI recorder application by D.Potter
  2.  
  3.  This is version 0.01 dated 3/6/90 with minor updates 22/10/90
  4.  
  5.  Released into the public domain under certain conditions. Please read on...
  6.  
  7.  This program was "thrown together" in a hurry for another musician who
  8.  needed a method to store and retrieve a complete memory dump of song and
  9.  voice data before the batteries died on his dream machine!
  10.  (He couldn't afford the rather high prices being asked for "professional"
  11.  packages which (as far as I know) can't handle straight data dumping and
  12.  reloading operations anyway!)
  13.  
  14.  It simply receives data from a MIDI source into memory in one of 2 data
  15.  formats. The stored data can then be saved to disc, and sent back out
  16.  again to the MIDI equipment when required.
  17.  If you get a "No space in RMA" error when you start it up, pull the RMA
  18.  bar in the task display window to give it some more space. 
  19.  
  20.  Clicking on the application icon a the disc directory simply opens a
  21.  window on the desktop and the recorder is controlled from there.
  22.  This application does not install itself on the icon bar. (yet!!)
  23.  It does not use any menus, the main window contains all command buttons.
  24.  I have no idea what colours are used in the window, as I only have a green
  25.  screen monitor - I hope everything is readable in colour!
  26.  
  27.  The system does not (at present) store the midi channel numbers at all,
  28.  although the channel numbers for any data received are displayed if the
  29.  view option is active.
  30.  When data is being transmitted by the program, the default midi channel
  31.  is used.
  32.  
  33.  There is no point in me supplying an example file for the data dump format,
  34.  as these will only work with compatible keyboards.
  35.  Timestamped data files when sent out as music/command data will only be
  36.  sensibly useable if the voices selected within them are similar types of
  37.  voices on the receiving keyboard. ie. there is no point in sending a drum
  38.  pattern to a keyboard which uses the voice numbers in the dump as different
  39.  versions of an organ!
  40.  The short example timestamped data file supplied ("ExTime") is just a
  41.  simple little tune which doesn't use any drum voices in case your system
  42.  doesn't support them.
  43.  Just drag it onto the !Midi window, connect the archimedes midi out to the
  44.  midi in on your keyboard, set the keyboard to midi sound source mode,
  45.  click on Transmit Data and see what happens!
  46.  Note that notes might be left hanging if you stop the transmission before
  47.  the end of the data - To stop them you must set the keyboard back to its
  48.  keyboard control mode.
  49.  
  50.  
  51.  ---- The Buttons in The Main Window ----
  52.  
  53.  "View" and "In Background"
  54.  These buttons control the use of an optional window which displays incoming
  55.  data. If the "View" button is highlighted then the window is opened,
  56.  clicking on "In Background" closes the window.
  57.  Note that displaying incoming data significantly slows down the system, so
  58.  the data will probably continue to appear in the window even after you have
  59.  stopped sending it from the keyboard - this is due to the buffering action
  60.  of the program.
  61.  (There is a bug in the re-drawing of this window which means that it will
  62.  not always be updated correctly.)
  63.  
  64.  Data Formats
  65.  To Select the data format to be used for reception and transmission,
  66.  click on one of the format boxes ("Timestamped Data (4 time+1 data)" or
  67.  "Straight data") and it will be highlighted.
  68.  **You should ONLY change the data format while the storage area is empty!**
  69.  If you change it while there is data in the store, it will be saved as the
  70.  wrong filetype! (There is a slight bug which causes the icon in the save
  71.  window to sometimes show the incorrect filetype, but files are saved
  72.  correctly.)
  73.  
  74.  - If the system is started by clicking on a suitable data file, or a data
  75.  file is dragged into the application window, then the filetype
  76.  of that data file will be recognised, and the data format set for you.
  77.  
  78.  --- I have used filetypes 006 and 007 for this program as I have not
  79.      registered any filetypes with Acorn or Norwich Computer Services.
  80.  --- This could cause problems if you are using any other applications which
  81.      use these filetypes.
  82.  
  83.  --- 006 is the default format ie 4 time bytes followed by 1 data byte.
  84.          You would use this to record and send out live or sequenced music.
  85.  --- 007 is for straight data dump ie memory/voice dump ignoring timing.
  86.          You would use this to record and send voice or song memory dumps
  87.          assuming this is supported on your keyboard.
  88.          I have found that the Yamaha keyboards tried with this application
  89.          which have a bulk memory dump capability selectable from their
  90.          control panel actually send the system exclusive code for the
  91.          re-load as the start bytes of the block dumped.
  92.          This may not be true of other keyboards, and you may have to insert
  93.          a system exclusive code at the start of your dumped files before
  94.          attempting to send them back to the keyboard.
  95.  
  96.  "Receive Data", "Stop", "Transmit Data", and "Save to Disc"
  97.  These buttons are fairly obvious in their use, but note the following.
  98.  When transmitting timestamped data back out to a keyboard, the U and D
  99.  keys on the keyboard are available to vary the transmission rate.
  100.  The transmission of timestamped data was the last addition made to the
  101.  program, and is not really correctly implemented at all!
  102.  The speed of transmission will vary on different models of Archimedes
  103.  computers as I eventually set the timing with a loop in BASIC rather than
  104.  using SYS"MIDI_InqSongPositionPointer" which is not much use as it's too
  105.  slow from BASIC in the desktop even when at full speed - Using FastClock
  106.  might be better, but I haven't tried that yet.
  107.  Clicking on the Save to Disc button is (naturally) only valid when there
  108.  is something in the store to save! Assuming that this is the case, a
  109.  standard save window will open showing the file name and icon for saving.
  110.  
  111.  "CLEAR / RESET"
  112.  Clicking on this button resets the system, clears the buffers and resets
  113.  the default save filename to "MidiData".
  114.  
  115.  The display of the number of commands in the store is different for the
  116.  2 data formats.
  117.  - If timestamped data is selected, the number of commands received in the
  118.    store is displayed, not the total number of bytes.
  119.  - If straight data is selected then the number of bytes in the store is
  120.    displayed.
  121.  
  122.  The box showing the present name of the file is purely that, it is for
  123.  information only and the name can not be edited there.
  124.  The filename is editable in the Save window only, and you MUST click in
  125.  the name icon in the window to give it the caret before trying to edit.
  126.  (Another little omission which makes it a bit non-standard!)
  127.  
  128. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  129.  
  130.   I MIGHT update this at some time, then again, I might not!
  131.   I know there are some silly bugs and some badly written bits in here -
  132.   I simply don't have the time to do anything more with it at present.
  133.   Anyone who wishes to continue from here is quite welcome, but PLEASE keep
  134.   me informed of improvements through one of the contact points below.
  135.   (Comments are also welcome, - well polite ones anyway!)
  136.  
  137.   ************************************************************************
  138.   *                                                                      *
  139.   *    ++   THIS APPLICATION MUST REMAIN IN THE PUBLIC DOMAIN!    ++     *
  140.   *                                                                      *
  141.   *            This application must not copied for profit.              *
  142.   *                                                                      *
  143.   *  You must copy the entire application including this rambling file.  *
  144.   *                                                                      *
  145.   *  No responsibility whatsoever will be accepted for any loss of data  *
  146.   *  etc. caused by the use (or misuse) of this system.                  *
  147.   *  This is not a finished application, and is offered as a free entry  *
  148.   *  point to midi recording for Archimedes users who wish to experiment *
  149.   *  with it.                                                            *
  150.   *                                                                      *
  151.   ************************************************************************  
  152.  
  153.   Contact points :  Archive    408
  154.                     Acorn SID  1271
  155.  
  156.   Douglas Potter    22.10.90
  157.  
  158.  
  159.  
  160.  If this file has just shot up the screen
  161.  to fast for you to read, load !Edit then 
  162.  try reading it again.
  163.  
  164.